Troubleshoot MS Teams Integration Issues
If you encounter issues during setup or synchronization, use the following guidance to resolve common problems.
Authentication errors
Symptom: Unable to connect to Microsoft Teams or login fails when selecting drives.
Possible causes and solutions:
| Cause | Solution |
|---|---|
| Incorrect credentials | Verify that the Client ID, Tenant ID, and Client Secret are entered correctly in VIDIZMO. Copy the values again from Microsoft Entra ID if needed. |
| Client secret expired | Create a new client secret in Microsoft Entra ID and update it in VIDIZMO portal settings. |
| App registered in wrong directory | Ensure the app is registered in your organization's main directory the same directory where users sign in to Microsoft Teams. |
| Admin consent not granted | In Microsoft Entra ID, go to API permissions and select Grant admin consent for your organization. |
Permission denied errors
Symptom: Error messages about insufficient permissions when accessing drives or folders.
Possible causes and solutions:
- Missing API permissions: Verify that both
User.ReadandFiles.ReadWritepermissions are added in Microsoft Entra ID. - User lacks access: Confirm the signed-in user has access to the SharePoint drives and folders they're trying to ingest.
- Group permission not enabled: Ensure you belong to a group with the integration app permission enabled in VIDIZMO.
Synchronization issues
Symptom: Content is not appearing in VIDIZMO after enabling the integration.
Possible causes and solutions:
| Symptom | Solution |
|---|---|
| Sync status shows "Running" for extended time | Large content libraries may take longer to sync. Check the Last Synced Attempt timestamp to monitor progress. |
| Sync status shows "Failed" | Review the error message displayed. Common causes include expired credentials or network connectivity issues. |
| Folders not appearing | Verify the correct Drive Type is selected. Confirm the folders contain supported file types. |
| Content missing after sync | Ensure the correct folders are selected under Import Settings. Only content in selected paths is ingested. |
Redirect URI errors
Symptom: Error during Azure authentication mentioning redirect URI mismatch.
Solution: Verify the Redirect URI in Microsoft Entra ID matches your portal domain exactly:
https://your-portal-domain/api/v1/apps/TeamsDriveSystem/authorize
Ensure there are no trailing slashes or typos in the URL.
Best practices
Follow these recommendations for a smooth integration experience:
- Monitor sync status regularly: Check the Sync Process and Last Synced Attempt fields to ensure content is being ingested successfully.
- Plan for client secret expiration: Note the expiration date of your client secret and create a new one before it expires to avoid service interruption.
- Start with a test folder: Select a small folder initially to verify the integration works before ingesting larger content libraries.
- Document your configuration: Save the Client ID, Tenant ID, and app registration details in a secure location for future reference.